Using eSignature and Acroform fields

eSignature feature overview

Features/elements available within the ESignatureAndFieldSupport element:

• eSignatureCoordinatesOnly: if set to "true," eSignature fields are suppressed on the form and X/Y coordinates are returned. .
• eSignatureDateSupport: allows users to enable or disable the date field in an eSignature. Setting the element to "true" enables the date field; setting the element to "false" disables the date field.
• eSignatureTooltip: allows users to pass a string as a help popup.
• eSignatureInitialsTooltip: allows users to pass a string as a help popup.
• NonSignatureFieldCoordinatesOnly: if set to "true," other Non-Signatures fillable fields (textboxes and checkboxes) are suppressed on the form and X/Y coordinates are returned.

Using SignaturePointSet and eSignatureAndFieldSupport

We have created a new element eSignatureAndFieldSupport with two child flags to control eSignatures and Non-Signature Fillable fields independently. At this time XY coordinates will only be passed for eSignature fields (esignatures, esig date, and initials). In a future release additional enhancements will be made to pass XY coordinates for other fillable fields.

Below is an explanation of these elements, the new flags, and their function together.

• SignaturePointSet: Existing element
  • If passed: XY Coordinates are returned for esignatures only, fields are not rendered on the form.
  • If not passed: XY Coordinates are returned for esignatures only, fields are rendered on the form.
  • Future Function: XY Coordinates will be returned for all fillable fields.
• eSignatureAndFieldSupport
  • eSignatureCoordinatesOnly: child of eSignatureAndFieldSupport
    • If true: XY Coordinates are not returned and fields are not rendered on the form.
    • False (Null): XY Coordinates are returned and fields are rendered on the form.
    • Future Function: XY coordinates will be returned when this flag is set to "True".
  • NonSignatureFieldCoordinatesOnly, child of eSignatureAndFieldSupport
  • If true: XY Coordinates are not returned and fields are not rendered on the form.
  • False (Null): XY Coordinates are not returned and fields are rendered on the form.
  • Future Function: XY coordinates will be returned when this flag is set to "True."

Enabling X/Y coordinates

In a future release, setting the eSignatureSupport and NonSignatureFieldSupport flags to true will suppress the field(s) on the form and return X/Y coordinates.

Considerations

Note the following:

• Users can turn on eSignatures for all transactions in the bsi.properties configuration file. By default, these values are set to "false."
  Note: Expere will pass the eSignatureSupport element settings in the transaction first; if no values exist, Expere will refer to the eSignatureSupport setting in the bsi.properties file.
• eSignature and Acroform field enablement is independent of each other.

SOAP Request

<AncillaryOutputOption>
	<OutputType>ESignatureAndFieldSupport</OutputType>
	<ESignatureAndFieldSupport>
		<eSignatureCoordinatesOnly>true</eSignatureCoordinatesOnly>
		<eSignatureDateSupport>true</eSignatureDateSupport>
		<eSignatureTooltip>test</eSignatureTooltip>
		<eSignatureInitialsTooltip>test1</eSignatureInitialsTooltip>
		<NonSignatureFieldCoordinatesOnly>true</NonSignatureFieldCoordinatesOnly>
	</ESignatureAndFieldSupport>
</AncillaryOutputOption>